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(ON Z-TaVTa07 


LiveCode 8.1 provides important improvements for delivering high-quality cross-platform 


applications! 


e LiveCode Indy and Business editions now come with the tsNet external, which supercharges 
LiveCode's Internet features and performance. LiveCode 8.1 also introduces mergHealthkit, 
for accessing activity, sport and health data on iOS devices. 


e The standalone builder now has a greatly-improved user experience for including externals, 
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script libraries and LiveCode Builder extensions in your cross-platform application. Usually, 
it'll now do the right thing automatically, but you can still select the specific inclusions you 
need. 


e The IDE has lots of other upgrades, too: a keyboard-navigable Project Browser that 
highlights any scripts that failed to compile, an improved dictionary user interface, and 
access to the message box just by starting to type. 


e The player control can be used in Windows application without any need for users to install 
any additional libraries or dependencies, thanks to a brand new player implementation 
based on DirectShow. For most apps, it should now be unnecessary to install or use 
QuickTime at all. 


e The LiveCode Builder programming language has had some enhancements as part of the 
Infinite LiveCode project. Variables now get initialised by default, unsafe blocks and 
handlers can be used to flag sections of code that do dangerous things, and you can even 
include raw bytecode if necessary. 


Known | < 


e The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 


e The browser widget does not work on 32-bit Linux. 


e 64-bit standalones for Mac OS X do not have support for audio recording or the 
revVideoGrabber external. 


The engine supports a variety of operating systems and versions. This section describes the 
platforms that we ensure the engine runs on without issue (although in some cases with reduced 
functionality). 


Windows 
LiveCode supports the following versions of Windows: 


e Windows XP SP2 and above 

e Windows Server 2003 

e Windows Vista SP1 and above (both 32-bit and 64-bit) 
e Windows 7 (both 32-bit and 64-bit) 

e Windows Server 2008 

e Windows 8.x (Desktop) 

e Windows 10 


Note: On 64-bit Windows installations, LiveCode runs as a 32-bit application through the WoW 
layer. 
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Linux 


LiveCode supports the following Linux distributions, on 32-bit or 64-bit Intel/AMD or compatible 
processors: 


e Ubuntu 14.04 and 16.04 

e Fedora 23 & 24 

e Debian 7 (Wheezy) and 8 (Jessie) [server] 
e CentOS 7 [server] 


LiveCode may also run on Linux installations which meet the following requirements: 
e Required dependencies for core functionality: 


o glibc 2.13 or later 
o GLib 2.0 or later 


e Optional requirements for GUI functionality: 


°0 GTK/GDK 2.24 or later 

o Pango with Xft support 

°o esd (optional, needed for audio output) 

o mplayer (optional, needed for media player functionality) 

© Icms (optional, required for color profile support in images) 
© gksu (optional, required for privilege elevation support) 


Note: If the optional requirements are not present then LiveCode will still run but the specified 
features will be disabled. 


Note: The requirements for GUI functionality are also required by Firefox and Chrome, so if your 
Linux distribution runs one of those, it will run LiveCode. 


Note: It may be possible to compile and run LiveCode Community for Linux on other 
architectures but this is not officially supported. 


Mac 
The Mac engine supports: 


e 10.6.x (Snow Leopard) on Intel 
e 10.7.x (Lion) on Intel 

e 10.8.x (Mountain Lion) on Intel 
e 10.9.x (Mavericks) on Intel 

e 10.10.x (Yosemite) on Intel 

e 10.11.x (El Capitan) on Intel 


IOS 
iOS deployment is possible when running LiveCode IDE on a Mac, and provided Xcode is installed 
and has been set in LiveCode Preferences (in the Mobile Support pane). 


Currently, the supported versions of Xcode are: 
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e Xcode 4.6 on MacOS X 10.7 

e Xcode 5.1 on MacOS X 10.8 

e Xcode 6.2 on MacOS X 10.9 

e Xcode 6.2 and 7.2 on Mac OS X 10.10 
e Xcode 7.3 on MacOS X 10.11 


It is also possible to set other versions of Xcode, to allow testing on a wider range of iOS 
simulators. For instance, on Yosemite, you can add Xcode 5.1 in the Mobile Support preferences, 
to let you test your stack on the /OS Simulator 7.1. 


We currently support the following iOS Simulators: 


e 6.1 
e 7.1 
e 8.2 
e 9.2 
e 9.3 


Android 


LiveCode allows you to save your stack as an Android application, and also to deploy it on an 
Android device or simulator from the IDE. 


Android deployment is possible from Windows, Linux and Mac OSX. 


The Android engine supports devices using ARMv6, ARMv7 or ARMV8 processors. It will run on the 
following versions of Android: 


e 2.3.3-2.3.7 (Gingerbread) 
e 4.0 (Ice Cream Sandwich) 
e 4.1-4.3 (Jelly Bean) 

e 4.4 (KitKat) 

e 5.0-5.1 (Lollipop) 

e 6.0 (Marshmallow) 


To enable deployment to Android devices, you need to download the Android SDK, and then use 
the 'Android SDK Manager' to install: 


e the latest "Android SDK Tools" 
e the latest "Android SDK Platform Tools" 


You also need to install the Java Development Kit (JDK). On Linux, this usually packaged as 
"openjdk". LiveCode requires JDK version 1.6 or later. 


Once you have set the path of your Android SDK in the "Mobile Support" section of the LiveCode 
IDE's preferences, you can deploy your stack to Android devices. 


Some users have reported successful Android Watch deployment, but it is not officially supported. 


HTML5 


LiveCode applications can be deployed to run in a web browser, by running the LiveCode engine in 
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JavaScript and using modern HTML5 JavaScript APIs. 
HTML5 deployment does not require any additional development tools to be installed. 


LiveCode HTML5 standalone applications are currently supported for running in recent versions of 
Mozilla Firefox, Google Chrome or Safari. For more information, please see the "HTML5 
Deployment" guide in the LiveCode IDE. 


CCU —SC‘;sCC 


Installation 


Each version of LiveCode installs can be installed to its own, separate folder. This allow multiple 
versions of LiveCode to be installed side-by-side. On Windows (and Linux), each version of 
LiveCode has its own Start Menu (or application menu) entry. On Mac OS X, each version has its 
own app bundle. 


On Mac OS X, install LiveCode by mounting the .dmg file and dragging the app bundle to the 
Applications folder (or any other suitable location). 


For Windows and Linux, the default installation locations when installing for "All Users" are: 


Platform Path 
Windows <x86 program files folder>/RunRev/LiveCode <version> 


Linux /opt/livecode/livecode-<version> 


The installations when installing for "This User" are: 


Platform Path 

Widoine Use (eetininlg app data folder>/RunRev/Components/LiveCode 
<version> 

Linux ~/.runrev/components/livecode-<version> 


Note: If installing for "All Users" on Linux, either the gksu tool must be available, or you must 
manually run the LiveCode installer executable as root (e.g. using sudo or su). 


Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible 
from the "Add or Remove Programs" applet in the windows Control Panel. 


On Mac OS X, drag the app bundle to the Trash. 


On Linux, LiveCode can be removed using the setup.x86 or setup.x86 64 program located in 
LiveCode's installation directory. 


Reporting installer issues 
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If you find that the installer fails to work for you then please report it using the LiveCode Quality 
Control Centre or by emailing support@livecode.com. 


Please include the following information in your report: 


e Your platform and operating system version 

e The location of your home or user folder 

e The type of user account you are using (guest, restricted, admin etc.) 
e The installer log file. 


The installer log file can be located as follows: 


Platform Path 
Windows 2000/XP <documents and settings folder>/<user>/Local Settings/ 
Windows Vista/7 <users folder>/<user>/AppData/Local/RunRev/Logs 


Linux <home>/.runrev/logs 


Activating LiveCode Indy or Business edition 


The licensing system ties your product licenses to a customer account system, meaning that you 
no longer have to worry about finding a license key after installing a new copy of LiveCode. 
Instead, you simply have to enter your email address and password that has been registered with 
our customer account system and your license key will be retrieved automatically. 


Alternatively it is possible to activate the product via the use of a specially encrypted license file. 
These will be available for download from the customer center after logging into your account. This 
method will allow the product to be installed on machines that do not have access to the internet. 


Command-line installation 


It is possible to invoke the installer from the command-line on Linux and Windows. When doing 
command-line installation, no GUI will be displayed. The installation process is controlled by 
arguments passed to the installer. 


Run the installer using a command in the form: 


<installer> install noui [OPTION ...] 


where <installer> should be replaced with the path of the installer executable or app (inside 


the DMG) that has been downloaded. The result of the installation operation will be written to the 
console. 


The installer understands any of the following OPTIONs: 


Option Description 


Install the IDE for "All Users". If not specified, LiveCode will be installed 


-allusers 
for the current user only. 
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: Option Place a shortcut on the Deskter.Qviagenmnonly) 
desktopshortcut 
-startmenu Place shortcuts in the Start Menu (Windows-only) 
-location The folder to install into. If not specified, the LOCATION defaults to those 
LOCATION described in the "Installation" section above. 
The file to which to log installation actions. If not specified, no log is 


-log LOGFILE ganenated, 


Note: the command-line installer does not do any authentication. When installing for "All Users", 
you will need to run the installer command as an administrator. 


As the installer is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


start /wait <installer> install noui [OPTION ...] 


Command-line uninstallation 


It is possible to uninstall LiveCode from the command-line on Windows and Linux. When doing 
command-line uninstallation, no GUI will be displayed. 


Run the uninstaller using a command of the form: 
<uninstaller> uninstall noui 


Where is .setup.exe on Windows, and .setup.x86 on Linux. This executable, for both of the 
platforms, is located in the folder where LiveCode is installed. 


The result of the uninstallation operation will be written to the console. 


Note: the command-line uninstaller does not do any authentication. When removing a version of 
LiveCode installed for "All Users", you will need to run the uninstaller command as an 
administrator. 


Command-line activation for LiveCode Indy or Business edition 


It is possible to activate an installation of LiveCode for all users by using the command-line. When 
performing command-line activation, no GUI is displayed. Activation is controlled by passing 
command-line arguments to LiveCode. 


Activate LiveCode using a command of the form: 


<livecode> activate -file LICENSEFILE -passphrase SECRET 


LiveCode 8.1.0 Release Notes 9/12/16 


where <lLivecode> should be replaced with the path to the LiveCode executable or app that has 
been previously installed. 


This loads license information from the manual activation file LICENSEFILE, decrypts it using the 
given SECRET passphrase, and installs a license file for all users of the computer. Manual 


activation files can be downloaded from the My Products page in the LiveCode account 
management site. 


It is also possible to deactivate LiveCode with: 
<livecode> deactivate 


Since LiveCode is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


start /wait <livecode> activate -file LICENSE -passphrase SECRET 
start /wait <livecode> deactivate 


On Mac OS X, you need to do: 


<livecode>/Contents/MacOS/LiveCode activate -file LICENSE -passphrase SECRET 
<livecode>/Contents/MacOS/LiveCode deactivate 


aletial= lalet= 


Change in empty is among the items of 1,2,3, behavior 
(8.1.0-rc-2) 


In previous versions of LiveCode is among the items of behaved incorrectly when a trailing 
delimiter was present. Trailing delimiters are generally ignored in the LiveCode engine and legacy 
behaviors where they are not are documented anomalies that are maintained for backwards 
compatibility reasons. This change resolves the anomaly detailed in bug report 16297 


For example: 


put the number of items of "1,2,3," is 3 --> puts true in all engines 
put empty is among the items of "1,2,3," --> puts true in LiveCode 6 
put empty is among the items of "1,2,3," --> puts false in LiveCode 8 


Warning If your stacks depend on the legacy anomalous behavior they should be 
checked to ensure all trailing empty items are wrapped by an item delimiter 
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Filtering array keys and elements has been added to the filter 
command (8.1.0-rc-1) 


The filter command now supports the filtering of arrays by matching keys or elements. 


Example: 


local tArray 

put true into tArray["foo"] 

put false into tArray["bar"] 
filter keys of tArray with "f*" 
put the keys of tArray is "foo" 


minStackFileVersion property (8.1.0-rc-1) 


A new stack property has been added to determine the minimum stack file version that can be 
safely used to save a stack without data loss. For example, if a widget is on the stack the 
minStackFileVersion will be 8.0 and saving with a lower stack file version will result in the loss 
of the widget from the stack. The minimum minStackFileVersion reported by the property is 
7.0. 


A new scriptStatus of object property has been implemented 
(8.1.0-rc-1 


Use the scriptStatus of <object> to determine the status of the last time the script 
property was set or the script was compiled when the stack was opened. 


ee non-BMP characters roundtrip through htmIText (8.1.0- 
rc- 


Previously, unicode characters outside of the basic multilingual plane (i.e. those with codepoint < 
65536) would fail to roundtrip through the htmlText property of fields. This has now been fixed. 


In addition, fixing this issue also means that unicode characters (of any codepoint) can now 
appear in the metadata attribute of 'p' and 'span' tags. 


Finally, the imageSource property can now span multiple characters. This is required to allow it to 
apply to surrogate pairs (i.e. characters with codepoint 


65535) and unicode character sequences which are considered a single 'char' (i.e. 
human readable character / grapheme). 


Group command does not return new group id in it (8.1.0-rc-1) 


The group command has been changed so that it returns the long id of the newly created group in 
the 'it' variable. 


10 
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If no group is created (as a result of using 'group' with an empty selection) the 'it' variable will be 
set to empty. 


List folders other than the default folder (8.1.0-dp-3) 


When called as a function, the files and folders functions now take an optional argument 
specifying which directory to list. This makes writing filesystem code a lot easier, since code that 
looked like: 


local tOldFolder, tFilesList 

put the defaultFolder into tOldFolder 

set the defaultFolder to "/path/to/target/directory" 
put the files into tFilesList 

set the defaultFolder to tOldFolder 

return tFilesList 


can be replaced with: 


return files("/path/to/target/directory") 


Fix truncation when saving erode where length 
exceeds 32767 characters. 


Note: This fix introduces a new stack file format version (8.1) which is required to preserve the 
paragraph text. Saving with a legacy stack file version will result in loss of data for field text 
affected by this bug. 


Changes to the dontUseQT Poe of a player object 
(Windows and OSX) (8.1.0-dp-2) 


It is now possible to set the dontUseQT property for a player object. 


On Windows, the default value of the global dontUseQt and dontUseQtEffects properties has 
changed from true to false. This means that by default players created on Windows will use the 
DirectShow API for multimedia playback. 


On OSX, QuickTime is unable to be supported in 64 bit builds the default value of the global 
dontUseQT and dontUseQTEffects properties changed in version 6.7; it is true on OS X version 
10.8 and up, or on all versions of OS X if the engine is 64 bit. This means that any player object 
created will use the AVFoundation API for multimedia playback. 


With this new feature, you can set the dontUseQT property of a player to false, without changing 
the value of the global dontUseQt property. If you do this, you can have both QuickTime and 
AVFoundation players playing at the same time, which can be particular useful for supporting 
some media formats or codecs that are not supported by the default AVFoundation or 
DirectShow player (for example .midi files, Sorenson Video 3, H.261 codecs etc) 
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Warning: QuickTime has not been maintained or supported by Apple for quite some time. You 
are encouraged to check your applications for any dependence on QuickTime, and remove it if 
found. 


Add several IDE messages (8.1.0-dp-2) 
Messages are now sent when audio clip and video clip controls are created or deleted. 


e newAudioclip: sent when an audio clip is created 

e deleteAudioclip: sent when an audio clip is deleted 
e newVideoclip: sent when a video clip is created 

e deleteVideoclip: sent when a video clip is deleted 


Improved return command (8.1.0-dp-2) 


The 'return' command has had two new forms added: 


return <value> for value 
return <value> for error 


When running in a command handler, the 'return ... for value' form will cause execution of the 
handler to halt, and control to return to the calling handler. At this point the 'it' variable in the 
calling handler will be set to 'value' and 'the result' will be set to empty. In contrast, the 'return ... 
for error' form will cause the '‘it' variable in the calling handler to be set to empty and ‘the result' to 
be set to 'value’. 


When running in a function handler, the 'return ... for value' form will cause execution of the 
handler to halt, and control to return to the calling handler. At this point the return value of the 
function call will be 'value', and ‘the result' will be set to empty. In contrast, the 'return ... for error’ 
form will cause the return value of the function call to be empty, and ‘the result' will be set to 
‘value’. 


These forms of return are designed to be used by script library functions to allow them to have 
the same ability as built-in engine functions and commands - namely the ability to return a value 
(in it for commands, or return value for functions) orreturn a status (in the result). 


Revert a target stack (8.1.0-dp-2) 


It is now possible to revert a stack that is not the topStack, using 


revert <stack reference> 


New vectorDotProduct function (8.1.0-dp-2) 


A new vectorDotProduct function has been added. It computes the vector dot product of two 
single-dimensional arrays with identical keys. 
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More specifically: 
vectorDotProduct(tArrayl, tArray2) 
Will compute: 


put 0.0 into tSum 
repeat for each key tKey in tArrayl 
add tArrayl[tKey] * tArray2[tKey] to tSum 
end repeat 
return tSum 


If the two arrays do not have the same set of keys, then an error is thrown. 


Add functions for getting synchronous modifier key state 
(8.1.0-dp-2) 


LiveCode currently provides functions for checking the state of so-called "modifier" keys: Caps 
Lock, Control, Command, Shift, Alt/Option. These functions return either "up" or "down", reflecting 
the state of the key at the time the function was called. However, it is often desireable to check 
the state of the key at the time the event was generated and this is not possible using these 
functions. 


New functions called "eventAltKey", "eventShiftkey", etc have been added; these return the state 
of the key at the time the event began processing. This is useful in keyDown and rawkeyDown 
handlers to check whether a modifier was pressed at the time the key the event relates to was 
pressed (if the non-event forms are used instead, there is a chance the modifier key has been 
released and the wrong result will be generated). 


Note that the "eventXxxXKey" functions should not be called after a wait; their value is undefined 
after any form of wait has occurred. 


Curly brace subscripts are now a syntax error (8.1.0-dp-2) 


Previously, it was possible to use curly brackets or braces {} instead of square brackets [] in 
array and custom property syntax. This was an undocumented and unknown feature to most 
users. 


Using {} to subscript arrays is nowa script syntax error. Curly brackets have been reserved for 
future use. 


eres Android timestamp accuracy for GPS and sensors 
(8.1.0-dp-2) 


Timestamps for sensors on Android were previously passed in a low-precision format, resulting in 
"sticky" timestamps that did not change more than a fewtimes a minute. This has now been 
resolved and timestamps are now reported to microsecond resolution (though the accuracy is 
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unlikely to be at the microsecond level). 


In addition to this change, the timestamps are now reported in "monotonic" time rather than 
"wall-clock" time ("wall-clock" time is the time you see reported as the current time). This means 
that the timestamps are now independent of changes to the device clock as a result of 
adjustments or daylight savings changes. If you want to match the readings to the device time 
instead, get the current time when receiving the location update rather than using the timestamp 
in the update. 


Improved GPS support on Android and iOS (8.1.0-dp-2) 


GPS behavior is now identical on Android and iOS. On both platforms, the location reading 
returned by the mobileSensorReading function is that which was sent with the last system 
locationChanged event. (This brings iOS behavior inline with that of Android). 


Additionally three new handlers have been implemented: 


mobileGetLocationHistory 
mobileSetLocationHistoryLimit 
mobileGetLocationHistoryLimit 


Whenever a system LocationChanged event occurs, the location reading is pushed onto the 
front of a list. The list is capped at the length set by the location history limit, dropping any old 
samples over this length. 


The mobileGetLocationHistory function returns a numerically keyed array of all accumulated 
samples since the last time it was called with lower indices being older samples. Calling the 
function clears the internal history. 


Each element in the array is the same format as the detailed location array as returned from the 
mobileSensorReading function. 


If an application wants historical access to all samples, then it should set the location history limit 
to the maximum number of samples it ever wants to record, or 0 to record the entire history 


(between calls to mobileGetLocationHistory). 


The best way to use the history is to fetch the list in LocationChanged and process each sample 
in turn, rather than the sample provided with the LocationChanged event (which will always be 
the last sample in the history). e.g. 


on locationChanged 
local tHistory 
put mobileGetLocationHistory() into tHistory 
repeat for each element tSample in tHistory 
processLocationChanged tSample 
end repeat 
end locationChanged 
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The default history limit is 1 meaning that only one sample is ever kept at a time. 


Automatic LCB extension inclusion in standalones (8.1.0-dp-1) 


When a standalone is built, the modules required for the widgets that are on the stack (or any of 
its substacks) are now included in the application automatically, regardless of whether the 'Search 
for required inclusions...' option is selected in the standalone settings. 


If ‘Search for required inclusions' is enabled, the scripts of the application will be searched for uses 
of the public handlers of any available LCB libraries, and any uses of the 'kind' of available widgets 
to determine whether the relevant modules are included. For example, if the script contains: 


create widget as "com. livecode.widget.svgpath" 


then the 'SVG Path' widget and all its dependencies will be included. 


Standalone ‘Search for inclusions' for mobile deployment 
(8.1.0-dp-1) 


The standalone builder 'Search for required inclusions...' option now supports mobile deployment, 
both to device and simulator. 


Standalone script library inclusions for mobile deployment 
(8.1.0-dp-1) 


Script libraries can now be included in mobile applications in the same way as for desktop 
applications, via the 'Inclusions' pane of the standalone builder. 


Windows DirectShow Player Control (8.1.0-dp-1) 


Due to the recent decision by Apple to end support for QuickTime on Windows, the player 
implementation on that platform has been replaced with one based on DirectShow. This is a 
multimedia API that is available by default on all versions of Windows supported by LiveCode. 


The new implementation should function as a drop-in replacement for the old one, though some 
properties are not yet implemented. 


Property Changes 
On Windows, the behaviour of some properties of the player control have changed. 


e The loadedTime property previously did not work on Windows, but now does. 
e The alwaysBuffer, enabledTracks, mediaTypes, mirrored, trackCount and tracks 
properties do not currently work, but will be re-enabled in a subsequent release. 


On all platforms, the following player control properties, which are specific to QuickTime and QTVR, 


have been deprecated: constraints, currentNode, movieControllerld, nodes, pan, tilt, and 
zoom. 
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Supported File Formats 
Media format support in the new Windows player control depends on which codecs are installed. 


A list of the file formats and compression types available as standard.aspx) on Windows is 
available in the MSDN documentation 


Add support for custom entitlements for iOS (8.1.0-dp-1) 


Custom entitlements can now be added to an iOS app by including one or more .xcent files in 
the copy files section of the standalone builder containing an XML snippet of key/value pairs. For 
example, if you wanted to add the entitlement for Homekit to your app you might create a file 
named HomeKit.xcent with the following content: 


<key>com.apple.developer.homekit</key> 
<true/> 


Specific engine bug fixes (8.1.0) 


18327 Calculate global MCmajorosversion in a more robust way 
savingStandalone and standaloneSaved should only be sent once when 


laa building for multiple platforms 


Specific engine bug fixes (8.1.0-rc-2) 


16397 Change in empty is among the items of 1,2,3, behavior 

18205 Fixed tsNet.dll "fails to initialise" error on Windows Server 2008/2012 Standard 

For external libUrl drivers, call the external function IvExtlsBlocked() to check for 

existing blocking connections 

18261 Fixed crash on 64-bit iOS simulator when tsNet/Internet lib is included in the 
standalone 

18282 Fix acrash after deleting a shared background group 


9571 Document menu item tags 


18247 


Specific engine bug fixes (8.1.0-rc-1) 


17646 Ignore trailing whitespace when parsing SVG paths 

17764 _ Fix widget drawing when attempting to draw empty strings 

17963 Allow building multiple Linux architectures at the same time 

17972 Fix missing fullscreenMode enum documentation 

Clean up empty folders after moving Copy files to resources folder in Mac 
standalones 

18042 Ensure guide PDF escapes special characters correctly. 


18031 
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18063 
18068 
18100 
18103 
18109 
18123 
18124 
18129 
18136 
18138 
18148 
18152 
18153 
18162 
18179 
18196 
18207 
18210 
18220 
18222 
18226 
18248 
18251 
6530 

7214 

7344 
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Fix color-swap when exporting image with more than 256 colors to GIF on Linux 
Ensure non-BMP characters roundtrip through htmlText 

Fix browser widget remaining visible after going to another stack on mobile 
Pass settings parameter to HTML5 builder correctly 

[Dict] mobileControlGet(myPlayer, "duration") is supported on Android 
Windows: fix crash when opening player from hidden stack 

Allow libUriFtpUpload and libUrlFtpUploadFile to support SFTP URLs 

Ensure matchChunk returns the correct char positions 

Make sure arithmetic commands throw errors for bad inputs 

Silence documentation parser warnings on non-doc block comments 

Fix inline example of using imageData to get color channels 

Fix browser position on Mac when shown in resized palette stack 

Fix browser widget disappearing when stack decorations changed 

Ensure Mac universal externals are found correctly 

Fix malformed dictionary entry for the "go" command. 

Add 8.1 file format to stack version glossary entry 

Fix Windows player playback of url streams 

Fix error message when copying uninstaller fails 

Ensure all relevant LCB interface files are present in IDE 

Fix widgets not being saved when on substack but not on main stack 
Make sure database drivers are included in the standalone 

Display appropriate error when trying to build script only standalones 

Fix video of player not automatically resized when setting filename 

Group command does not return new group id in it 

Examples in dictionary entries referring to file paths should be updated 
Correct named shades of gray (Gray1-100) to match the X11 color names 


Specific engine bug fixes (8.1.0-dp-3) 


17149 
17392 
17633 
17690 
17782 
17868 
17890 
17922 
17937 
17957 
17959 
17961 
17965 
17971 
18019 
18041 


Ensure iconGravity property is preserved when copying/cloning buttons. 
Ensure line endings of utf-8 docs are converted 

Fix long delay when launching standalone displaying a browser widget 

Fix truncation when saving field paragraphs where length exceeds 32767 characters. 
Fix incorrect measurement and placement of rotated text on Windows 

Only save standalone stackfile for current standalone target 

Fix player callbacks still calling after being cleared 

Check standalone stack for widgets before resolving dependencies 

Make sure the action of 'return for' is local to the caller. 

Ensure V1 externals can set it when handlers called from top-level in server. 
Fix a crash on iOS 9 when rendering subviews 

Fix error in layerMode dictionary entry 

Do something sensible when GDK reports a maximum cursor size of 0 

Fix formatting of resizeStack message docs entry 

Ensure cards with objects on can be deleted 

Ensure codeunitOffset and codepointOffset return 1 indexed offset 
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Make sure cookie filePath is set correctly 
Allow check for private among the keys of the fullDragData 


Specific engine bug fixes (8.1.0-dp-2) 


15183 
17180 
17275 
17317 
17469 
17523 
17553 


17609 


17637 
17661 
17662 
17697 
17698 
17700 
17701 
17708 
17747 
17754 
17776 
17781 
17797 
17815 
17828 
17834 
17842 
17844 
17856 


17891 


Ensure dependencies of built-in inclusions are included 

Ensure deleted objects executing scripts can not be deleted 

Add functions for getting synchronous modifier key state 

Deprecate liveResizing and metal stack properties 

Curly brace subscripts are now a syntax error 

Fix LCB docs builder handling of string-like property names 

Paint Tools Not Working in IDE 

Return an empty item instead of a random value if altitude reading is not available on 
iOS 

Update docs to reflect changes to standalone builder inclusions 
Improve Android timestamp accuracy for GPS and sensors 
Improved GPS support on Android and iOS 

Fix player view occasionally not showing on Mac 

Fix Windows player frame seeking 

Fix Windows player not pausing when in edit mode 

Fix incorrect Windows player rect on opening 

Fix incorrect player currenttime value for videos longer than 7m 15s 
Make sure widgets get mouseUp in popup stacks 

Ensure external code blobs are included in standalones 

Parse deprecated LCB syntax properly 

Fix OSX mouse event errors when using QTKit player 

Enable playback of MP3 and other audio files in Windows player 

Fix native layer of player not showing when stack opened 

Fix player slider moving outside its track boundary 

Prevent possible assertion failure related to revMessageBoxRedirect 
Ensure read from socket documentation matches engine behavior 
Allow the dropChunk function to parse as a chunk reference 

Deal with pdfPrinter inclusion setting correctly 

Reset the m_was_licensed instance variable to true before calls to an external's 
handler 


Specific engine bug fixes (8.1.0-dp-1) 


17515 
17573 


Add support for custom entitlements for iOS 
Don't retain other platforms' temporary standalone settings data 


IDE Changes SCC 
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Script compilation errors are now indicated on the project 
browser (8.1.0-rc-1 


The Project Browser will now indicate objects that have scripts that were not able to be compiled. 
The script line number indicator will appear red for scripts with errors. 


Tutorial stack browser display (8.1.0-rc-1) 


The tutorial system can now display a browser widget set to a url given in its specification. In order 
to do so, simply include the url as a section of the step in question. For example: 


step "Instructions With Browser" 
Please watch the following video with detailed instructions on how 
to proceed. 
url 
<url of video> 
action 
interlude 
go to step "Create New Mainstack" 
end step 


Search for user tutorials (8.1.0-rc-1) 


The revIDEStartTutorial command will now search both in the IDE and in the user's 
My LiveCode/Interactive Tutorials/ folder for tutorials to start. 


So for example, an interactive tutorial placed at 


My LiveCode/Interactive Tutorials/courses/Database 
Course/tutorials/SQLite/lessons/1. Introduction.txt 


can be run using 


revIDEStartTutorial "Database Course", "SQLite", "1. Introduction" 


SEseeee navigation has been added to the project browser 
O-rc-1 


The project browser now supports the following keyboard actions: 


e up and down arrowKey - move up and down the object list 
e left and right arrowKey - contract and expand child objects 
e returnKey - open object 

e shift + returnKey - open script 
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e shift + option + returnKey - open behavior script 
e command + returnKey - open inspector 


ideControlMoved message (8.1.0-dp-3) 


ideControlMoved has been added to the set of IDE messages to which other objects can 
subscribe. ideControlMoved pTarget is dispatched to all subscribers after the control 
pTarget is moved with the pointer tool (i.e. in edit mode) in the IDE. 


Ignore moveStack and resizeStack execution errors in script 
ebug mode (8.1.0-dp-3) 


Previously when in script debug mode an execution error in the context of a moveStack or 
resizeStack handler would cause the IDE hang and occasionally crash. 


Deprecated syntax in the dictionary (8.1.0-dp-2) 


Deprecated syntax is now be prefixed in the dictionary entry list by a warning icon. 


Dictionary UI Improvements (8.1.0-dp-2) 
The dictionary stack UI has been updated to incorporate a few user interface improvements: 


e The panel containing list of entries that match the current filter and search terms is now 
resizable, and contains three columns - the name of the entry, the type, and the syntax. 
The list can be sorted by any of these three. 

e The history breadcrumb has been condensed into back and forward buttons, plus a history 
dropdown menu button. 

e The filters pane now has associations and platforms filter categories, and is now scrollable if 
the content is too large for the pane. The numbers associated with each filter have been 
removed. The list of filters is laid out in two columns, sorted in alphabetical order. 


Autofocus on message box when typing (8.1.0-dp-2) 


If the message box is open, it will now automatically gain focus and receive keystrokes when you 
start typing with no field focused. This makes it much faster and more convenient to quickly run 
message box commands without hunting for the message box. 


Standalone Inclusions Interface (8.1.0-dp-1) 


The standalone settings user interface has been reworked to unify the notion of app inclusion. 
There is now an 'Inclusions' pane which allows the user to select from a complete list of available 
inclusions. The list contains information about which platforms are supported. 


The ‘Inclusions’ pane significantly improves the cross-platform development experience provided 
by LiveCode (since the iOS and Android panes no longer have separate check boxes for the 
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various built-in externals such as revxml), as well as paving the way for much better extensibility 
in the future. 


Specific IDE bug fixes (8.1.0-rc-2) 


18265 
18270 


Ensure message box is colorized correctly when the script editor hasn't been opened 
Ensure preferences are changed when LiveCode quits 


Specific IDE bug fixes (8.1.0-rc-1) 


14217 
15708 
17520 
17660 


17663 


17693 
17696 
17863 
17870 
17902 
17925 
17991 
18026 
18047 
18053 
18134 
18140 


18158 


18166 
18169 
18170 
18174 
18175 
18183 
18208 
18214 
18249 
4695 


Keyboard navigation has been added to the project browser 

Don't offer to make substacks of script-only stacks 

Fix IDE error on View > Palettes menu 

Ensure IDE sends ideSelectedObjectChanged message when selecting objects 
Fixed typo in file association message displayed at startup when launching new 
version of LC 

Correctly identify the stack when building a standalone from the project browser 
Player control's default video doesn't work in Windows player 

Improve message box autocompletion and error handling 

Improved speed of formatting scripts 

Ensure apply button on variable visualiser enables correctly 

Ensure LCB modules are recompiled when Ic-compile is updated 

Make Windows systemVersion handling in revDeleteFolder more robust 
Maintain scroll when focussing in on inclusions card in standalone build 

Fix object grouping menu items from contextual menus 

Use appropriate cursors for selection handles 

Colorize the message box with script colorization settings 

Move text properties to text pane of Pl 

[Project Browser] Fix distorted view with nested groups and object_type_indicator == 
name 

Windows menu now shows stack names while the LC script window is on top 
[Extension Builder] Make sure scrollbar is visible when console_content > field_height 
[Extension Builder] Make console content selectable and thus enable copying 
Sort Script Editor handler list alphabetically per each different type 

Present a warning dialog if preserving stack file version will result in data loss 
Give the focus to the search box in the API Reference when it opens 

Make sure that file selector for field contents allows "All Files" 

Typo in LiveCode Builder doc 

Removed double extension of script only stacks on Linux and Windows 

Fixed runtime error when saving as legacy 


Specific IDE bug fixes (8.1.0-dp-3) 


11834 


Don't encode/decode iOS app name in standalone settings 
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17409 
17461 
17521 
17586 
17594 
17600 
17690 
17718 
17740 
17755 
17765 
17768 
17852 
17895 
17929 
17932 
17948 
18081 
2867 
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List all loaded stacks in the behavior picker 

Ensure toolbar can not cover fullscreen window widget on Mac 

Output array-style parameter descriptions correctly 

Make "value" field of Custom Properties Inspector scrollable 

Fix backspace handling in project browser field editor 

Fix Refresh Data Grid button in Pl 

Add 8.0 file format as an option in "Save as.." dialog 

Ensure property inspector is visible 

Improved formatting of line continuations in the script editor 

Ensure modal dialogs aren't moved to the main screen by script 

Fix typo in BMI Interactive Tutorial text 

Fix swapped labels in Project Browser footer 

Make sure multiple object text style/align props don't change on their own 
Documentation for setting dgText [TRUE] is ambiguous 

Prevent names in Dictionary overlap other columns 

Don't resolve angle brackets as links in code in descriptions 

Ensure the showinvisibles of script editors is false 

Ensure widget docs are generated on Windows 

Ignore moveStack and resizeStack execution errors in script debug mode 
Ensure IDE stacks are not listed in recentCards 


Specific IDE bug fixes (8.1.0-dp-2) 


16167 
16325 
17146 
17405 
17467 
17739 
17759 


17826 


296 
8985 


Remove reference to Windows XP from preferences stack 

Ensure preferences reset correctly 

Ensure that the Script Editor "Find" Ul resizes correctly 

Display virtual font names correctly in the script editor font preference menu 
Fix recent files list update issue 

Make object list in project browser flat when sorting by name 

show alpha values of gradients dynamically 

Make sure "move" command results in smooth movement when executed from the 
msg box 

Autofocus on message box when typing 

Clicking type disambiguation in Docs pane of Script Editor should work 


Specific IDE bug fixes (8.1.0-dp-1) 


17189 


Replace Revolution text with LiveCode in Dialogs 
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LiveCode Builder Standard Library 
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List operations 


e The & operator can now be used to concatenate two Lists. For example, 
[1, 2] & [3, 4] evaluatesto [1, 2, 3, 4]. 


LiveCode Builder Language 


Core types 


e The use of the keyword undefined, which was deprecated in LiveCode 8.0.0, has been 
removed. Use nothing instead. 


o Use returns nothing when defining a handler which returns no value. 
o Use nothing to indicate no value when manipulating optionally type variables 


e The is defined, is undefined, is not defined, and is not undefined syntax, 
which was deprecated in LiveCode 8.0.0, has been removed. Use is and is not with 
nothing instead. 


o Use <expr> is nothing and <expr> is not nothing to test whether an 
expression has a value or not 

o The expression <left> is <right> will now evaluate to true if <left> and 
<right> are both nothing 

o The expression <left> is not <right> will now evaluate to true if one of 
<left> or <right> are nothing (but not both). 


Variables 
e Out parameters are now initialized by default to a suitable empty value at the start of the 


handler. For example: 


public handler GetMyValue(out rValue as Integer) 
end handler 


will result in rValue being set to 0. 


e Handler local variables are now have lexical scope. This means variables are accessible 
from the point of definition to the end of the block they are defined in. Note that: 


° each repeat control structure is considered a single block. 


° each separate block in an if/else if/else control structure is considered a single 
block. 


e Variables are now reset (either to their default value, or unassigned) at the point of the 


variable definition. In particular, any variables defined within a repeat block are reset on 
each iteration: 
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repeat 5 times 
variable tVar as optional String 


-- tVar is reset to "nothing" every time the loop runs 
end repeat 


e Variables in an inner block can now shadow those in an outer block. For example, the 
following is valid: 


variable tX as Array 
repeat 5 times 
variable tX as Number 
repeat 4 times 
variable tX as String 
end repeat 
end repeat 


e Typed variables are now initialised by default to a suitable empty value. For example: 


variable tList as List 
push "element" onto tList 


Untyped and optional variables are initialised to nothing. 


Bytecode Blocks 


e bytecode can now be directly written in handlers using a bytecode block: 


bytecode 
register tTemp 


assign constant tTemp, 1 
end bytecode 


e for more details on what bytecode operations can be used see the LiveCode Builder 
Bytecode Reference 


e bytecode blocks are not for general use and the current set of bytecode operations are 
subject to change 


Unsafe Attributes 


e The compiler now understands the idea of 'safety' of handlers and blocks of code. 


e Handlers can be marked as being ‘unsafe’, e.g. 
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unsafe handler Foo() 
. do unsafe things ... 
end handler 


e Blocks of statements can be marked as being ‘unsafe’, e.g. 


unsafe 
. do unsafe things ... 
end unsafe 


e All foreign handlers are considered to be ‘unsafe’. 


e All bytecode blocks are considered to be ‘unsafe’. 


e Calls to foreign handlers and unsafe handlers can only be made within unsafe handlers or 
unsafe statement blocks. 


e Usage of bytecode blocks can only be made within unsafe handlers or unsafe statement 
blocks. 


Specific LCB bug fixes (8.1.0-rc-1) 


15181 Implement the & concatenation operator for List 
18194 Return value of correct type when using ‘the width of widget' 


Specific LCB bug fixes (8.1.0-dp-3) 


18022 Multiline block comment should terminate initial line. 


Specific LCB bug fixes (8.1.0-dp-2) 


16212 Escape XML reserved characters in manifest files 
17526 Make variables lexically scoped in statement blocks. 
17767 Process escape sequences in all string literals. 
17809 Initialize out parameters to default. 


Specific LCB bug fixes (8.1.0-dp-1) 


14659 Initialise variables with a default value 
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Line Graph widget 


Show and hide the graph lines 


Setting the showLines of the graph to false will draw the point markers but not the connecting 
lines turning the graph into a scatter plot. 


Marker styles 
The markerStyles of the line graph can now be set to a return delimited list of: 


e circle 

e filled circle 

e square 

e filled square 
e diamond 

e filled diamond 


Setting the markerStyles to empty will cause the lines of the chart to draw without markers and 
set the showLines of the chart to true. 


SVG Icon widget 


Properties 


e NewscaledWidth and scaledHeight properties have been added. These are read-only 
properties that expose the effective size of the rendered SVG path, independent of the 
widget's size. 


When maintainAspectRatio is false, these values are equal to the width and height of the 
widget. 


Specific extension bug fixes (8.1.0-dp-3) 


18054 Ensure that appearance reflects loaded state 


Dictionary additions 


e deleteAudioclip (message) has been added to the dictionary. 

e deleteVideoclip (message) has been added to the dictionary. 

e eventAltKey (function) has been added to the dictionary. 

e eventCapsLockKey (function) has been added to the dictionary. 

e eventCommandKey (function) has been added to the dictionary. 
e eventControlKey (function) has been added to the dictionary. 

e eventOptionKey (function) has been added to the dictionary. 

e eventShiftKey (function) has been added to the dictionary. 

e libURLSetDriver (command) has been added to the dictionary. 

e minStackFileVersion (property) has been added to the dictionary. 
e mobileGetLocationHistory (function) has been added to the dictionary. 
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e mobileGetLocationHistoryLimit (function) has been added to the dictionary. 

e mobileSetLocationHistoryLimit (command) has been added to the dictionary. 
e newAudioclip (message) has been added to the dictionary. 

e newVideoclip (message) has been added to the dictionary. 

e scriptStatus (property) has been added to the dictionary. 

e vectorDotProduct (function) has been added to the dictionary. 
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